%macropackage=lplaing
% MakeIndex(L) Unix-Man "Ubersetzung
% Von Thomas Schulze 1989,1990
% MakeIndex Version 2.9/1.3
%
% letzte "Anderung: 18-Aug-90
%
\documentstyle[11pt,german,twoside]{article}

\def\mi{{\it MakeIndex\/}}
\def\BibTeX{{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em
    T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}}

\pagestyle{myheadings}
\markboth{\mi\ Dokumentation}{\mi\ Dokumentation}

\setlength{\parindent}{0pt}
\setlength{\parskip}{5pt plus 2pt minus 1pt}

\frenchspacing
\flushbottom

\title{\mi\ Dokumentation}
\author{Thomas Schulze \\ H"ufferweg 17\\
4790 Paderborn \\ 0\,52\,51/64\,7\,64\\[0.5ex]
ts@euler.uni-paderborn.de\\
{\viipt(\dots !uunet!unido!pbinfo!euler!ts)}}
\date{18. August 1990}
\begin{document}
\maketitle
%\makeauthor 

\section{Vorwort}
Im \mi -Release befindet sich eine Anleitung 
zur Benutzung des Programms in Verbindung mit \LaTeX .Das war und
ist f"ur fast alle Anwendungen ausreichend, doch \mi\ 
kann viel mehr! Mit Hilfe der sogenannten \verb#sty#-Dateien kann
man, "ahnlich wie in \LaTeX\ und in \BibTeX , das Layout des 
Index in weiten Teilen beeinflussen. Weiterhin kann \mi\ mit einer
solchen Datei an andere Formatierprogramme (z.B. \verb#troff/nroff#)
angepasst werden. (Eine solche Datei liegt bei.)

\section{Name} 
\mi\ - ein allgemeines Index Programm f"ur \TeX , \LaTeX , und nroff.

\section{Synopsis}
{\tt \bf makeindx [-ilqrcg] [-s sty] [-o ind] [-t log] [-p no] [idx0 idx1 ...]}

\section{Beschreibung}
\mi\ liest eine Datei mit Indexeintr"agen
 (\verb#.idx#-Files), sortiert diese
und erzeugt eine Datei mit sortierten und zusammengefa"sten Eintr"agen, die z.B. von \LaTeX\ 
automatisch eingelesen und verarbeitet werden kann.

Das {\sc Default}-Format f"ur \mi\ ist \LaTeX , durch Angabe einer expliziten
Style-Datei kann dieses ge"andert werden.

Die Schachtelungstiefe der Unterabschnitte (\verb#subitems#) innerhalb eines Eintrages
kann maximal
3 betragen. Der Name der Eingabedatei bestimmt den Namen der Ausgabedatei,
dies kann durch Angeben eines expliziten Namens ge"andert werden. 

\section{Optionen}
\begin{itemize}
\item{\bf -i} \mi\ liest seine Eingaben von der Standardeingabe (stdin, Tastatur).
 Wenn diese Option angegeben wird und {\bf -o} nicht, so wird die Ausgabe
 auf die Standardausgabe (stdout, Bildschirm) gelenkt.
\item{\bf -l} Buchstabensortierung. Standardm"a"sig werden ganze W"orter sortiert.
\item{\bf -q} Quiet mode. Standardm"a"sig werden sowohl Fehlermeldungen als auch
 alle anderen Meldungen  nach stderr und in die {\tt .LOG}-Datei geschrieben.
 Diese Option unterdr"uckt die Ausgabe auf stderr (Bildschirm).
\item{\bf -r} Standardm"a"sig werden drei oder mehr aufeinanderfolgende Seitenzahlen
 zu einer Bereichsangabe gek"urzt (page range, z.B. 1--5). Die {\bf -r}-Option
 verhindert dies, so da"s Bereichsangaben explizit gefordert werden m"ussen.
\item{\bf -c} Leerzeichen-Komprimierung einschalten. Standardm"a"sig sind auch
 Leerzeichen in Schl"usselw"ortern relevant. Durch Angabe dieser Option werden 
 f"uhrende und abschlie"sende Leerzeichen  ignoriert, alle im Schl"usselwort
 enthaltenen mehrfachen Leerzeichen werden jeweils zu einem einzigen gek"urzt.
\item{\bf -g} Normalerweise sortiert \mi\ in folgender Reihenfolge: Erst
 Symbole, dann Nummern, dann Gro"sbuchstaben und dann Kleinbuchstaben. F"ur
 den deutschen Sprachraum ist jedoch eine andere Reihenfolge normal, n"amlich
 Symbole, Kleinbuchstaben, Gro"sbuchstaben und dann erst Nummern. Mit dieser
 Option sortiert \mi\ nach deutschen Konventionen ({\sc Din 5007}). Weiterhin werden
 mit dieser Option auch deutsche \TeX -Umlaute wie z.b. \verb|"a|, \verb|"u|
 usw. richtig sortiert. Dies geschieht durch eine interne Umkodierung dieser
 Zeichen in die entsprechenden zusammengesetzten, also \verb|ae|, \verb|ue|
 usw. Wenn nach deutschen Konventionen sortiert werden soll, dann mu"s das
 \verb|quote|-Zeichen (normalerweise \verb|"|) neu definiert werden, zum Beispiel
 als \verb|+|. 
\item{\bf -s sty} L"adt die Datei {\bf sty} als Style-Datei ein. Standarm"a"sig
 wird keine Style-Datei eingeladen. Der Environment-String {\sc Indexstyle}
 legt den Pfad fest, von dem diese Dateien geladen werden. In der Shell,
 die zum \TeX\ von Stefan Lindner mitgeliefert wird, wird dies durch explizite
 Pfadangabe beim Aufruf erledigt. Es gibt zwar keine festgelegte Extension f"ur
 \mi -Style Dateien, doch in Anlehnung an \BibTeX\ empfiehlt sich {\tt .mst}
 oder {\tt .ist}.
\item{\bf -o ind} Definiert {\bf ind} als den Namen der Ausgabedatei. 
 Standarm"a"sig ist dies der Grundname der Eingabedatei mit Suffix {\tt .ind}.
\item{\bf -t log} Definiert {\bf log} als den Namen der {\sc Log}-Datei.
 Standarm"a"sig ist dies der Grundname der Eingabedatei mit Suffix {\tt .ilg}.
\item{\bf -p no} Setzt die erste Seitennummer der Ausgabedatei auf die Nummer
 {\bf no}. Dies ist n"utzlich wenn der Index seperat formatiert werden soll.
 F"ur {\bf no} sind nicht nur Zahlen erlaubt:
 \begin{itemize}
  \item{\bf any} Die Seitennummer der ersten Seite ist die letzte Seitennummer
   des Textes plus eins.
  \item{\bf odd} Die Seitennummer der ersten Seite ist die n"achste {\em ungerade}
   Seitenummer.
  \item{\bf even} Die Seitennummer der ersten Seite ist die n"achste {\em gerade}
   Seitennummer.
 \end{itemize}
 Die letzte Seitennummer liest \mi\ aus der {\sc Log}-Datei des originalen
 Textes. Der Name dieser Datei wird aus dem Grundnamen der Eingabedatei
 mit Suffix {\tt .log} gebildet. Die Seitennummer selber wird in der entsprechenden
 Datei durch suchen nach {\tt [...]} gefunden. Falls diese Datei nicht gefunden
 werden kann oder in ihr keine Seitennummern angegeben sind, so wird die Option
 ignoriert.
\end{itemize}

\section{Style Dateien}
Wie gesagt, mit Hilfe der sogenannten Style-Dateien kann man die Formatierung
des Index nach pers"onlichen W"unschen ver"andern. In \LaTeX\ z.B wird der Index
von der {\tt theindex}-Umgebung gesetzt. In dieser Umgebung werden die einzelnen
Eintr"age durch {\tt item}-Kommandos gekennzeichnet. Der Platz, der zwischen
den Indexeintr"agen oder zwischen den Indexkategorien eingef"ugt wird, kann
so ver"andert werden. 
Das Format einer Style-Datei ist recht einfach. Es ist eine Liste von
{\tt <specifier,~attribute>} Paaren. Es gibt zwei verschiedene {\tt specifier}
Typen (Eingabe={\sc Input} und Ausgabe={\sc Output}). Eine besondere Ordnung ist nicht 
n"otig. Es folgt nun eine Liste aller {\tt specifiers}. Das \verb#%#-Zeichen ist,
wie auch in \TeX\, die Einleitung eines Kommentars, {\tt <string>} ist eine
Zeichenkette eingeschlossen in {\tt \dq }, {\tt <char>} ist ein einzelnes
Zeichen eingeschlossen in {\tt ' } und {\tt <number>} ist ein 
Integer-Wert\footnote{Achtung! Im englischen Original stand hier, das eine
{\em number\/} ein positiver Integerwert sein mu"s. Das ist nicht richtig,
auch wenn das nur bei einer Definition benutzt wird.}.
Die maximale L"ange eines {\tt <string>} ist normalerweise 1024 Zeichen.
Auf Rechnern, die nicht genug Speicher haben, kann diese L"ange auch
auf 144 Zeichen beschr"ankt sein.  Achtung, auch
in \mi\ ist das \verb#\#-Zeichen ein Fluchtzeichen.

F"ur alle nicht in der Style-Datei spezifierten Werte/Kommandos werden die
Standardeinstellungen angenommen.
Diese sind \LaTeX -konform.

\subsection{INPUT STYLE SPECIFIERS}

\begin{itemize}
\item \verb#keyword <string># \hfill \verb#"\\indexentry"# \\
 Dies ist das Kommando
 das \mi\ mitteilt, da"s sein Argument ein Indexeintrag ist.
\item \verb#arg_open <char># \hfill    \verb#'{'#  \\ Klammer auf f"ur Indexeintrag.
\item \verb#arg_close <char># \hfill   \verb#'}'#  \\ Und Klammer zu f"ur Indexeintrag.
\item \verb#range_open <char># \hfill  \verb#'('#  \\ Klammer auf f"ur explizite 
 Bereichsangabe.
\item \verb#range_close <char># \hfill  \verb#')'# \\ Und Klammer zu f"ur explizite
 Bereichsangabe.
\item \verb#level <char># \hfill  \verb#'!'#        \\ Das Begrenzungszeichen f"ur eine neue 
 Schachtelungsebene.
\item \verb#actual <char># \hfill  \verb#'@'#       \\ Das `Escape'-Zeichen, um den n"achsten
 Eintrag so wie er ist zu bearbeiten (durchzureichen).
\item \verb#encap <char># \hfill  \verb#'|'#        \\ Das Zeichen, das anzeigt, da"s der Rest
 des Eintrags ein Kommando zur Bearbeitung der Seitennummer ist.
\item \verb#quote <char># \hfill  \verb#'"'#        \\ Kein Kommentar n"otig.
\item \verb#escape <char># \hfill  \verb#'\'#       \\ Das Zeichen das das n"achste Zeichen
 `escaped', also "uberspringt. Mit anderen Worten, \verb#quote# wird benutzt, um
 das folgende Zeichen zu "uberspringen. Falls jedoch \verb#quote# von einem
 \verb#escape# angef"uhrt wird, so wird nichts "ubersprungen. Achtung! Diese
 beiden Zeichen m"ussen voneinander verschieden sein.
\end{itemize}

\subsection{OUTPUT STYLE SPECIFIERS}

\begin{itemize}
\item \verb#preamble <string>#
 \hfill  \verb#"\\begin{theindex}\n"# \\
 Die Preamble der aktuellen Index-Datei.
\item \verb#postamble <string>#
 \hfill  \verb#"\n\n\\end{theindex}\n"# \\
 Die Postamble der aktuellen Index-Datei.
\item \verb#setpage_prefix <string># 
 \hfill  \verb#"\n\\setcounter{page}{"# \\ Das
 Prefix f"ur das Kommando, das die erste Seitennummer setzt.
\item \verb#setpage_suffix <string>#
 \hfill  \verb#"}\n"# \\ Der Suffix f"ur das Kommando, das die erste 
 Seitennummer setzt.
\item \verb#group_skip <string># 
 \hfill  \verb#"\n\n  \\indexspace\n"# \\
 Der vertikale Abstand der zwischen zwei Gruppen gesetzt wird.
\item \verb#headings_flag <number>#
 \hfill \verb#0# \\
 Das Flag, das bestimmt, ob vor einer neuen Gruppe (Symbole, Nummern,
 Gro"s- und Kleinbuchstaben) ein Vorspann eingef�gt werden soll.
 Falls das Flag 0 ist wird kein Vorspann eingef"ugt.
 Positiv bedeutet, da"s ein Gro"sbuchstabe eingef"ugt wird,
 negativ, da"s ein Kleinbuchstabe eingef"ugt wird. 
\item \verb#heading_prefix <string># 
 \hfill  \verb#""# \\ Das Vorspann-Prefix, das eingef"ugt 
 wird bevor eine neue Gruppe\footnote{Mit Gruppe ist einer der 
 Hauptbuchstaben, nach denen sortiert wird, gemeint. (A,...,Z usw.)} beginnt. 
\item \verb#heading_suffix <string>#
 \hfill \verb#""# \\ Das Vorspann-Suffix.
\item \verb#symhead_positive <string>#
 \hfill \verb#"Symbols"# \\
 Vorspann f�r Symbole wenn \verb#headings_flag# positiv ist.
\item \verb#symhead_negative <string>#
 \hfill \verb#"symbols"# \\ 
 Vorspann f�r Symbole wenn \verb#headings_flag# negativ ist.
\item \verb#numhead_positive <string>#
 \hfill \verb#"Numbers"# \\
 Vorspann f�r Nummern wenn \verb#headings_flag# positiv ist.
\item \verb#numhead_negative <string>#
 \hfill \verb#"numbers"# \\ 
 Vorspann f�r Nummern wenn \verb#headings_flag# negativ ist.
\item \verb#item_0 <string># 
 \hfill  \verb#"\n  \\item "# \\ Das Kommando, das zwischen
 zwei Eintr"agen der Schachtelungstiefe 0 eingef"ugt wird.
\item \verb#item_1 <string># 
 \hfill  \verb#"\n     \\subitem "# \\ Das Kommando, das zwischen
 zwei Eintr"agen der Schachtelungstiefe 1 eingef"ugt wird.
\item \verb#item_2 <string># 
 \hfill  \verb#"\n       \\subsubitem "# \\  Das Kommando, das
 zwischen zwei Eintr"agen der Schachtelungstiefe 2 eingef"ugt wird.
\item \verb#item_01 <string># 
 \hfill  \verb#"\n     \\subitem "# \\ Das Kommando, das 
 zwischen einem Element der Tiefe 0 und einem der Tiefe 1 eingef"ugt wird.
\item \verb#item_x1 <string># 
 \hfill  \verb#"\n     \\subitem "# \\ Das Kommando, das
 zwischen einem Element der Tiefe 0 und einem der Tiefe 1 eingef"ugt.
 Der Unterschied zu dem Vorhergehenden Kommando besteht darin, da"s das
 erste Element von keiner Seitennummer gefolgt wird.
\item \verb#item_12 <string># 
 \hfill  \verb#"\n       \\subsubitem "# \\ Das Kommando, das 
 zwischen einem Element der Tiefe 1 und einem der Tiefe 2 eingef"ugt wird.
\item \verb#item_x2 <string>#
 \hfill  \verb#"\n       \\subsubitem "# \\ Das Kommando, das zwischen einem Element der
 Tiefe 1 und einem der Tiefe 2 eingef"ugt wird. Der Unterschied zum dem
 Vorhergehenden Kommando besteht darin, da"s das erste Element von keiner
 Seitennummer gefolgt wird.
\item \verb#delim_0 <string>#
 \hfill  \verb#", "# \\ Das Kommando, das zwischen einem Schl"usselwort der Tiefe 0
 und dessen erster Seitennummer eingef"ugt wird.
\item \verb#delim_1 <string>#
 \hfill  \verb#", "# \\ Dasselbe f"ur Schachtelungstiefe 1.
\item \verb#delim_2 <string>#
 \hfill  \verb#", "# \\ Und auch noch f"ur Tiefe 2.
\item \verb#delim_n <string>#
 \hfill  \verb#", "# \\ Das Kommando, welches zwischen zwei Seitennummern zum selben 
 Schl"usselwort (Schachtelungstiefe egal) eingef"ugt wird.
\item \verb#delim_r <string>#
 \hfill  \verb#"--"# \\ Das Kommando, das zwischen zwei Seitennummern einer 
 Bereichsangabe eingef"ugt wird.
\item \verb#delim_t <string>#
 \hfill \verb#""# \\ Das Kommando, das am Ende einer Seitennummern-Liste angef"ugt
 wird. Dieser Delimiter hat keinen Effekt auf Eintr"age, zu denen keine
 Seitennummern angef"uhrt werden.
\item \verb#encap_prefix <string>#
 \hfill  \verb#"\\"# \\ Der Prefix f"ur das `Einschlie"sungskommando'.
\item \verb#encap_infix <string>#
 \hfill  \verb#"{"# \\ Der Infix f"ur das `Einschlie"sungskommando'.
\item \verb#encap_suffix <string>#
 \hfill  \verb#"}"# \\ Der Suffix f"ur das `Einschlie"sungskommando'.
\item \verb#line_max <number>#
 \hfill  \verb#72# \\ Die maximale L"ange einer Zeile in der Ausgabedatei bevor die
 entsprechende Zeile umgebrochen wird.
\item \verb#indent_space <string>#
 \hfill  \verb#"\t\t"# \\ Der Freiraum vor einer umgebrochenen Zeile. (2 Tabs)
\item \verb#indent_length <number>#
 \hfill  \verb#16# \\
 Die L"ange des Freiraums bei \verb#indent_space#, standardm"a"sig
 16, also 2 Tabs. 
\end{itemize}

    
\subsection{Beispiel}
Das folgende Beispiel zeigt eine Style-Datei namens \verb#book_index.mst#
welche einen `stand-alone'\footnote{Achtung, eigene Kommandos in Indexeintr"agen
sind nat"urlich nicht bekannt und m"ussen manuell eingef"ugt und definiert werden.}
Index f"ur ein Buch definiert. Mit `stand-alone'
ist gemeint, da"s der Index unabh"angig vom sonstigen Buchtext formatiert
werden kann:
{\small
\begin{verbatim}
% Anfang der Datei
preamble 
"\\documentstyle[12pt]{book} 
\\begin{document} 
\\begin{theindex} 
{\\small\n"

% Ja, wir f"ugen den jeweiligen Buchstaben ein,
% und zwar halbfett.
heading_prefix
"\n\n{\\bf "

heading_suffix
"}\n\n "

% >0 => Gro"sbuchstabe 
headings_flag
1

postamble
"\n\n}
\\end{theindex}
\\end{document}\n".
% Das war's schon.
\end{verbatim}
}

\section{Sortieren}
Standardm"a"sig sortiert \mi\ nach dem {\tt word-ordering} Prinzip, also nach
ganzen W"ortern. Die {\bf -l}-Option "andert dies auf {\tt letter-ordering},
also nach jedem Buchstaben. Der einzige Unterschied besteht in der Behandlung
von Leerzeichen. Im {\tt word-ordering}-Modus wird ein f"uhrendes Leerzeichen
vor allen anderen Buchstaben einsortiert, im {\tt letter-ordering}-Modus
werden Leerzeichen dagegen ignoriert.

Zahlen (Seitennummern) werden in numerischer Reihenfolge sortiert.
Beim Sortieren von W"ortern bzw. Buchstaben wird Gro"s- oder Kleinschreibung
solange ignoriert bis zwei Eintr"age gleich sind, erst dann wird auf
die Schreibweise geachtet.

Eintr"age, die von einem nicht US-ASCII-Zeichen angef"uhrt werden, werden noch
vor Zahlen einsortiert. Das gilt leider auch f"ur deutsche Umlaute und andere
Zeichen, die in der Tabelle nach dem `z' stehen. Ab und zu mu"s man der \verb#.ind#-
Datei also doch noch per Hand den letzten Schliff geben (sic!).

Durch die {\bf -g}-Option verh"alt sich \mi\ beim Sortieren en wenig anders.
Wie schon weiter oben beschrieben wird dann nach deutschen Konventionen
sortiert. Ein Problem darf allerdings nicht verschwiegen werden: Bei
Benutzung der Umlaut-Makros aus der {\tt german.sty}-Datei gelangen die
Umlaute expandiert in die {\tt .idx}-Datei. In dieser Form erkennt \mi\ 
aber nicht, da"s es sich um Umlaute handelt. Folge: Deutsches Sortieren
klappt doch nicht. Bei Benutzung der "`originalen"' \TeX\ bzw. \LaTeX\ 
Umlaute gibt es zum Gl�ck keine Probleme und die Sortierung ist wirklich
deutsch.


\section{Spezial Effekte}
Normalerweise werden Eintr"age im `Source'-\verb#idx#-File wie z.B.
\begin{verbatim}
\indexentry{alpha}{1}
\indexentry{alpha!beta}{3}
\indexentry{alpha!beta!gamma}{10}
\end{verbatim}
konvertiert zu
\begin{verbatim}
\item alpha, 1
\subitem beta, 3
\subsubitem gamma, 10.
\end{verbatim}
Beachten Sie, da"s das Zeichen \verb|!| benutzt wird, um Schachtelung
im Index zu erzeugen.

\begin{sloppypar}
Ein Index"-ein"-trag, der durch den `actual'-%
Operator aus"-ge"-zeichnet ist wie z.B.
\verb|\indexentry{alpha@{\it alpha\/}}{1}|
wird durch \mi\ zu 
\verb|\item {\it alpha\/} 1|.
Die Idee dahinter ist, da"s der Eintrag vor dem \verb|@| (sprich: {\em at})
zum Sortieren
benutzt wird, w"ahrend im Index nachher der Eintrag {\bf nach} dem \verb|@|
erscheint. 
\end{sloppypar}

Weiterhin kann man eine Seitennummer durch den \verb#|#-Operator einschlie"sen
(sprich: {\em pipe}).
Durch
\begin{verbatim}
\indexentry{alpha|bold}{1}
\end{verbatim}
wird
\begin{verbatim}
\item alpha \bold{1}
\end{verbatim}
erzeugt, wobei \verb|\bold{n}| zu \verb|{\bf n}| expandieren soll.
Damit kann man verschiedene Seitennummern zu ein und demselben
Indexeintrag in verschiedenen Zeichens"atzen formatieren, um zum Beispiel
auf besonders wichtige Seiten hinzuweisen. 

Mit dem Einschlie"sungsoperator kann man auch auf andere Indexeintr"age 
verweisen:
\begin{verbatim} 
\indexentry{alpha|see{beta}}{1}
\end{verbatim}
expandiert zu
\verb|\item alpha \see{beta}{1}|,
wobei das \verb#\see# Kommando zu \verb|{\it see\/}beta| wird.
Bei diesem Verweis wird "ubrigens {\bf keine} Seitennummer angegeben.

Eine explizite Bereichsangabe kann man durch die Angabe des \verb#|(#- sowie
des \verb#|)#-Operators erreichen:
\begin{verbatim}
\indexentry{alpha|(}{1}
\indexentry{alpha|)}{5}
\end{verbatim}
expandiert zu
\begin{verbatim}
\item alpha, 1--5.
\end{verbatim}
Auch explizite Bereichsangaben kann man durch einen anderen Zeichensatz 
oder ein anderes Attribut auszeichnen:
\begin{verbatim}
\indexentry{alpha|(bold}{1}
\indexentry{alpha|)}{5}
\end{verbatim}
expandiert zu
\begin{verbatim}
\item alpha, \bold{1--5}.
\end{verbatim}
In diesem Zusammenhang sind einige Spezial"-f"alle erw"ahnenswert. 
Eintr"age der Form
\begin{verbatim}
\indexentry{alpha|(}{1}
\indexentry{alpha|bold}{3}
\indexentry{alpha|)}{5}
\end{verbatim}
werden als
\begin{verbatim}
\item alpha, \bold{3}, 1--5
\end{verbatim}
interpretiert. Allerdings wird eine Warnung der Form
"`inconsistent page encapsulator"' ausgegeben.
Weiter"-hin wird bei einer expliziten Bereichs"-angabe, die bei einer r"omischen
Seiten"-nummer
beginnt und mit einer arabischen endet, eine Fehlermeldung ausgegeben. In so
einem Fall mu"s man weitere `Unter'-Bereichsangaben vornehmen.

Jedes Spezialzeichen wie z.B. \verb|@| kann durch ein `\verb|"|'
Zeichen (sprich: {\em quote}) `escaped'
werden, das hei"st das Zeichen wird als normales Zeichen erachtet.
Falls allerdings dieses Anf"uhrungszeichen von dem Standard Escape Zeichen
\verb#'\'# angef"uhrt wird, so wird ein Umlaut-Akzent erzeugt.
In dieser Form kann zum Beispiel \TeX\ Texte mit Umlauten korrekt setzen.

Achtung, der {\tt quote}-Operator mu"s bei eingeschalteter {\bf -g}-Option umdefiniert
werden!

\section{Siehe auch}
Weitere Erl"auterungen im \TeX book oder in verschiedenen
\LaTeX\ B"uchern.
Siehe auch die Datei {\tt makeindx.tex}, die
eine Anleitung f"ur die Benutzung von \mi\ mit \LaTeX\ 
darstellt. Hier ist auch ein Beispiel-Index von Nelson Beebe enthalten.
Die Beschreibung von \verb#qsort()# finden Sie entweder im Handbuch Ihres
C-Compilers oder in der g"angigen Literatur\footnote{Oder auch in der Datei
qsort.c , die im wesentlichen aus diesem Algorithmus besteht.}.

\section{Autor}
Autor der englischen Originalanleitung sowie des Programms \mi\ ist: \\
Pehong Chen \\
Computer Science Division \\
University of California, Berkely \\
phc@renoir.berkely.edu

\section{Danksagung}
Leslie Lamport hat viel zum Design von \mi\ beigetragen.
Wertvolle Kommentare und Hinweise gab Michael Harrison.

\section{Deutsche "Ubersetzung}
Die deutsche "Ubersetzung sowie die Portierung von \mi\ auf den Atari ST
wurde von Thomas Schulze vorgenommen. Alle
Unklarheiten oder Fehler in diesem Text liegen deshalb ganz und gar
in falscher "Ubersetzungsarbeit begr"undet. Der "Ubersetzer "ubernimmt
keine Garantie f"ur die Richtigkeit oder N"utzlichkeit dieser Anleitung
oder des Programms \mi\ auf dem Atari ST.
Das Programm \mi\ ist Public Domain, wer genaueres wissen m�chte, der lese
sich bitte die Datei COPYING durch. Die dort angegebenen Bedingungen gelten
selbstverst"andlich auch f"ur die Atari Version.

\section{Atari ST Version}
Die Portierung auf den Atari ST wurde nach bestem Wissen und Gewissen
vorgenommen, und
mittlerweile\footnote{Achtung, das Angeben einer expliziten Seitennummer
f"ur den Index funktioniert erst ab ST Version 1.1!} verh"alt sich \mi\ auf dem Atari ST genau wie die entsprechenden
Versionen f"ur andere Betriebssysteme und Rechner. Ein Hinweis in eigener
Sache: Alle \mi -Versionen f"ur den Atari kleiner 1.2 haben einen Fehler.
Der verwendete \verb#qsort# in diesen Versionen ist der von Turbo C Version
1.1, und der ist fehlerhaft. Falls also Eintr�ge verschwinden o."a., dann
liegt es daran. In der Version 1.2 habe ich denn doch wieder den Quicksort
eingebunden, der bei den \mi -Quellen dabei ist. Ich sollte wohl in
Zukunft darauf verzichten, Teile der Distribution so zu ver"andern.
Die in dieser Anleitung
beschriebene Version ist "`portable version 2.9, Atari ST version 1.3"'.
Diese Version enth�lt auch die Fehlerkorrekturen der alten 2.5a Version,
die hiermit ausgedient hat.

Und last but not least eine Danksagung an alle, die bei der Erstellung der
\verb#portable version 2.9# von \mi\ mitgewirkt haben und damit die
Arbeit der Portierung bis auf ein Minimum reduziert haben. (Siehe auch Datei
{\tt CONTRIB}.)


Noch Fragen? Unklarheiten? Anregungen oder Fehler im Programm ?
Dann schreiben Sie mir doch einfach an die oben angef"uhrte Adresse,
rufen Sie mich an oder mailen Sie an die genannte e-mail Adresse.

\end{document}
